package cn.com.huzo.service.master;

import cn.com.huzo.model.entities.master.CustomerEntity;
import huzofw.service.GenericManager;
import java.util.List;
import java.util.Map;

/**
 * 客户信息管理服务对象接口。
 *
 * @author 吴旭
 */
public interface CustomerManager extends GenericManager<CustomerEntity, Long> {

    /**
     * 取得客户信息
     *
     * @param criterion
     * @return
     * @throws Exception
     */
    Map<String, Object> fetchByHeaderId(Map<String, Object> criterion) throws Exception;

    /**
     * 根据给定客户编号取得客户信息对象。
     *
     * @param customerNo 客户编码
     * @return 客户信息对象
     * @throws java.lang.Exception
     */
    CustomerEntity fetchByCustomerNo(String customerNo) throws Exception;

    /**
     * 取得客户表的字段列表。
     *
     * @return 字段名和汉字描述列表
     * @throws java.lang.Exception
     */
    List<CustomerEntity> fetchAllFields() throws Exception;

    /**
     * 根据给定导出条件取得客户信息对象。
     *
     * @param criterion 导出过滤条件
     * @return 客户信息对象
     * @throws java.lang.Exception
     */
    List<String> fetchExportData(Map<String, Object> criterion) throws Exception;

    /**
     * 批量更新客户所属目录。
     *
     * @param itemList 要更新的客户数据列表
     * @return 影响的行数
     * @throws java.lang.Exception
     */
    Integer batchChangeCatalogue(List<CustomerEntity> itemList) throws Exception;
}
